Skip to content

deepagents: profiles#3683

Draft
Mason Daugherty (mdrxy) wants to merge 12 commits intomainfrom
mdrxy/da-profiles
Draft

deepagents: profiles#3683
Mason Daugherty (mdrxy) wants to merge 12 commits intomainfrom
mdrxy/da-profiles

Conversation

@mdrxy
Copy link
Copy Markdown
Member

No description provided.

@github-actions github-actions Bot added deepagents For docs changes to Deep Agents oss internal labels Apr 22, 2026
ccurme

This comment was marked as outdated.

@mdrxy Mason Daugherty (mdrxy) changed the title deepagents: document provider and harness profiles deepagents: profiles Apr 23, 2026
@github-actions github-actions Bot added the langsmith For docs changes to LangSmith label Apr 23, 2026
Copy link
Copy Markdown
Contributor

@npentrel Naomi Pentrel (npentrel) left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So there's no option to set a profile for ALL providers&models? For example if I wanted to use all the defaults except the todo middleware?

Comment thread src/oss/deepagents/models.mdx Outdated
Comment thread src/oss/deepagents/profiles.mdx Outdated
Comment on lines +53 to +61
<Accordion
title="Lookup order for preconfigured model instances"
>
When you pass a preconfigured chat model instance instead of a `provider:model` string, the harness synthesizes the canonical `provider:identifier` key from the instance and looks it up in this order:

1. Exact `provider:identifier` match
2. Identifier-only (only when the identifier already contains `:`)
3. Provider-only fallback
</Accordion>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should this maybe be with registration keys instead?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or it could be in the parameter table

Comment on lines +18 to +24
- `base_system_prompt` — replace the base Deep Agents system prompt
- `system_prompt_suffix` — append text to the base system prompt
- `tool_description_overrides` — override individual tool descriptions
- `excluded_tools` — remove specific harness-level tools from the tool set
- `excluded_middleware` — strip specific middleware classes from the stack
- `extra_middleware` — append middleware to every stack this profile applies to
- `general_purpose_subagent` — disable, rename, or re-prompt the general-purpose subagent
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think let's put these into a table under the code sample to make this easier to look through

| --- | --- |
| `base_system_prompt`, `system_prompt_suffix` | New value wins when set; otherwise inherits |
| `tool_description_overrides` | Mappings merge per key; new value wins on a shared key |
| `excluded_tools`, `excluded_middleware` | Sets union |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo I think

Suggested change
| `excluded_tools`, `excluded_middleware` | Sets union |
| `excluded_tools`, `excluded_middleware` | Set union |

Comment thread src/oss/deepagents/profiles.mdx Outdated
Comment thread src/oss/deepagents/profiles.mdx
Mason Daugherty (mdrxy) and others added 4 commits April 24, 2026 10:17
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-mdrxyd-1777040498-5598059

Site preview: https://langchain-5e9cc07a-preview-mdrxyd-1777040498-5598059.mintlify.app

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

Only the top 5 changed markdown files by diff size are listed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents internal langsmith For docs changes to LangSmith oss

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants